home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / SCIENTIF / H558.ZIP / AM_SEIS.ZIP / AMSEIMAN.TXT next >
Text File  |  1992-09-25  |  63KB  |  1,565 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                             The Amateur Seismology Package
  24.  
  25.                                     User's Manual
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                             Rev 1.2.0 (September 25, 1991)
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.           Copyright (c) 1991 Robert K. Samuelson.  All rights reserved.
  40.                              Dept. 256
  41.                              4215 Winnetka Ave. N.
  42.                              New Hope, MN 55428 USA
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.           The Amateur Seismology Package User's Manual                    1
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.                                   Table of Contents
  72.  
  73.  
  74.           1.0  Introduction . . . . . . . . . . . . . . . . . . . . . .   3
  75.                1.1  Copyright Notices . . . . . . . . . . . . . . . . .   3
  76.                1.2  Disclaimer  . . . . . . . . . . . . . . . . . . . .   4
  77.                1.3  Distribution  . . . . . . . . . . . . . . . . . . .   4
  78.  
  79.           2.0  User Support . . . . . . . . . . . . . . . . . . . . . .   4
  80.  
  81.           3.0  Data File Distribution . . . . . . . . . . . . . . . . .   5
  82.  
  83.           4.0  Bibliography . . . . . . . . . . . . . . . . . . . . . .   6
  84.  
  85.           5.0  SEISGRAPH  . . . . . . . . . . . . . . . . . . . . . . .   9
  86.                5.1  Overview  . . . . . . . . . . . . . . . . . . . . .   9
  87.                5.2  Installation  . . . . . . . . . . . . . . . . . . .   9
  88.                5.3  Guided Tour . . . . . . . . . . . . . . . . . . . .  10
  89.                5.4  Features  . . . . . . . . . . . . . . . . . . . . .  13
  90.                     5.4.1     Invoking SEISGRAPH  . . . . . . . . . . .  13
  91.                     5.4.2     Reading Data Files  . . . . . . . . . . .  13
  92.                     5.4.3     Adjusting X Limits  . . . . . . . . . . .  13
  93.                     5.4.4     Adjusting Y Limits  . . . . . . . . . . .  14
  94.                     5.4.5     Autorange . . . . . . . . . . . . . . . .  14
  95.                     5.4.6     Guide Window  . . . . . . . . . . . . . .  15
  96.                     5.4.7     Data Window . . . . . . . . . . . . . . .  15
  97.                     5.4.8     Printing  . . . . . . . . . . . . . . . .  15
  98.                     5.4.9     Setup String  . . . . . . . . . . . . . .  16
  99.                          5.4.9.1   b (Binary File)  . . . . . . . . . .  16
  100.                          5.4.9.2   e (Eight Bit File) . . . . . . . . .  17
  101.                          5.4.9.3   x (Skip Bytes) . . . . . . . . . . .  17
  102.                          5.4.9.4   c (Color)  . . . . . . . . . . . . .  17
  103.                          5.4.9.5   a (Autorange)  . . . . . . . . . . .  18
  104.                          5.4.9.6   s (Samples Per Second) . . . . . . .  18
  105.                          5.4.9.7   b (Bin Size) . . . . . . . . . . . .  18
  106.                          5.4.9.8   p (Printer Port) . . . . . . . . . .  18
  107.                          5.4.9.9   d (Printer Driver) and r
  108.                               (Resolution)  . . . . . . . . . . . . . .  19
  109.                5.5  Data File Format  . . . . . . . . . . . . . . . . .  20
  110.                5.6  Problems and Solutions  . . . . . . . . . . . . . .  20
  111.  
  112.           6.0  How Data Files Are Created . . . . . . . . . . . . . . .  22
  113.  
  114.           7.0  The Future . . . . . . . . . . . . . . . . . . . . . . .  23
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.   1.0     Introduction
  138.  
  139.           The Amateur Seismology Package is a collection of programs, data
  140.           files, and documentation which allows users of IBM (*1)
  141.           compatible personal computers to load seismic data files and
  142.           print seismograms.
  143.  
  144.           Seismograms are graphs of the motion of the Earth's surface at a
  145.           given location due to the passing waves caused by a distant
  146.           earthquakes and can be used to determine, among other things, the
  147.           distance between the earthquake and the recording station's
  148.           location.
  149.  
  150.           The Amateur Seismology Package is intended for use by 'amateur
  151.           scientists' and students who are interested in the Earth sciences
  152.           in general and seismology in particular.  The package will allow
  153.           users to study seismograms of recent earthquakes using data files
  154.           distributed by the author.  The data files are produced by the
  155.           author's seismometer and recording system.
  156.  
  157.           Data files for notable events will be distributed as quickly as
  158.           practical.  Data files which are contaminated with noise or
  159.           contain little of interest will probably not be distributed
  160.           unless requested by a user who has also recorded the event.
  161.  
  162.           ALL DATES AND TIMES ASSOCIATED WITH SEISMIC DATA WILL BE IN
  163.           COORDINATED UNIVERSAL TIME (UTC), ALSO KNOWN AS GREENWICH MEAN
  164.           TIME (GMT) OR 'ZULU' (Z).
  165.  
  166.           Rather than explain the science of seismology and the practices
  167.           of seismometry here, the reader is directed to the Bibliography. 
  168.           These sources will provide the information needed to gain a
  169.           qualitative understanding of seismology and the techniques of
  170.           seismometry.  Some sources describe the construction of
  171.           seismometers and recording systems which can be constructed by
  172.           electronic hobbyists.
  173.  
  174.           *1   IBM is a trademark of International Business Machines
  175.                Corporation.
  176.  
  177.  
  178.   1.1     Copyright Notices
  179.  
  180.           Elements of the Amateur Seismology Package (also referred to as
  181.           'the package') are identified by the phrase 'part of the Amateur
  182.           Seismology Package.' Those elements which are copyrighted contain
  183.           a copyright notice.  This notice appears near the beginning of
  184.           documents, on the opening screen of programs, and is encoded in
  185.           ASCII near the beginning of data files.  The phrase 'all rights
  186.           reserved' means a person or organization other than the author
  187.           may copy and distribute elements of the package only under those
  188.           conditions defined in the 'Distribution' portion of this manual. 
  189.           In particular, no element of the package may be distributed
  190.           unless accompanied by this user's manual.
  191.  
  192.  
  193.  
  194.  
  195.           The Amateur Seismology Package User's Manual                    3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.   1.2     Disclaimer
  203.  
  204.           The author hereby disclaims all warranties relating to the
  205.           Amateur Seismology Package.  All elements of the package are
  206.           provided 'as is' and are not guaranteed to be suitable for any
  207.           particular purpose.
  208.  
  209.  
  210.   1.3     Distribution
  211.  
  212.           The Amateur Seismology Package may be duplicated and distributed
  213.           by persons or organizations other than the author subject to the
  214.           following conditions:
  215.  
  216.                Elements may be duplicated for backup purposes as desired.
  217.  
  218.                Modified elements may not be distributed. 
  219.  
  220.                Elements may be distributed as long as no fee is charged
  221.                other than a nominal fee to cover the cost of the media
  222.                used.  
  223.  
  224.                If distributed via a bulletin board system (BBS), no
  225.                additional charge beyond normal connect time or access fees
  226.                may be made.
  227.  
  228.                Any element distributed must be accompanied by The Amateur
  229.                Seismology Package User's Manual.
  230.  
  231.  
  232.   2.0     User Support
  233.  
  234.           The first two versions of this package (versions 1.0.0 and 1.1.0)
  235.           requested a support fee from users in exchange for adding the
  236.           user's name to a mailing list.  The solicitation of a support fee
  237.           implied that this package was 'commercial'.
  238.  
  239.           Many information resources (networks, government funded BBS's,
  240.           etc.) do not permit such solicitation of funds.  In order to
  241.           promote the free flow of information, I have decided to
  242.           discontinue the solicitation of a support fee and distribute the
  243.           package and data files free of charge.  However, my copyright and
  244.           the restrictions set forth in the 'Distribution' portion remain.
  245.  
  246.           Since a support fee is no longer being solicited, users are asked
  247.           to include return postage if requesting information via mail. 
  248.           Users are also asked to remember that this is the author's
  249.           'hobby' and that the demands of home and career will have a
  250.           higher priority.
  251.  
  252.           The Amateur Seismology Package support address is contained in
  253.           the copyright notice.  Support can also be obtained by contacting
  254.           the author via electronic mail on CompuServe (ID 70531,3012) or
  255.           either of the BBS's on which this package is distributed (address
  256.           messages to user name Robert Samuelson).
  257.  
  258.  
  259.  
  260.  
  261.           The Amateur Seismology Package User's Manual                    4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.           There is no telephone support for this package.  Please use
  269.           electronic mail when possible.
  270.  
  271.  
  272.   3.0     Data File Distribution
  273.  
  274.           The primary location for this package and the activities
  275.           associated with it will be the 'Mahoney MS-DOS file collection'
  276.           of the EXEC-PC BBS.  EXEC-PC can re reached at (414) 789-4210
  277.           (use 8 data bits, no parity, 1 stop bit).  EXEC-PC access costs
  278.           about $20 for three months or $60 for one year.  You may
  279.           subscribe online.  Even if primary distribution eventually moves
  280.           to another BBS, the files will continue to be distributed in
  281.           parallel on EXEC-PC at least through the end of 1992.
  282.  
  283.           The author is not associated with EXEC-PC and cannot guarantee
  284.           that EXEC-PC will always be available.  Any questions about EXEC-
  285.           PC should be directed to its sysop.
  286.  
  287.           Beginning September 25, 1991, this package and data files will
  288.           also be distributed via the NEIC BBS on a trial basis (see
  289.           Bibliography).
  290.  
  291.           Users are encouraged to form their own networks and post the data
  292.           files regularly on other BBS systems.
  293.  
  294.           This package and the data files were originally distributed
  295.           through CompuServe (*1).  The change to EXEC-PC was made largely
  296.           due to the fact that files uploaded to EXEC-PC are immediately
  297.           available while uploads to CompuServe can take a day or more to
  298.           become available.  Also, CompuServe's service agreement appears
  299.           to frown upon the practice of systematically copying files from
  300.           CompuServe to other systems.  This is not to say that users
  301.           cannot post these files on CompuServe, just that the author will
  302.           be using another service as the primary distribution point.
  303.  
  304.           The author is currently using PKZIP (*2) and PKUNZIP for file
  305.           compression.  These utilities are usually distributed as the
  306.           self-extracting file PKZ110.EXE.  PKZ110.EXE (or a newer version)
  307.           is available on most BBS system.  Remember that the PKWARE
  308.           packages also depend upon user support.
  309.  
  310.           *1   CompuServe is a registered mark of CompuServe, Inc.
  311.           *2   PKZIP and PKUNZIP are trademarks of PKWARE, Inc.
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.           The Amateur Seismology Package User's Manual                    5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.           The data file for a given event will be a created from several
  336.           individual data files and an optional text file.  The individual
  337.           data files will each contain ten minutes of data and will have
  338.           names of the form mmddhhmm.dat, where mmddhhmm represents the
  339.           month, day, hour, and minute of the file time stamp.  The event
  340.           data file will have a name of the form yymmddhh.zip, where
  341.           yymmddhh represents the year, month, day, and hour of the first
  342.           .dat file of the event.
  343.  
  344.           For example, 'unzipping' the event file 91070612.zip yields
  345.           07061226.dat, 07061236.dat, 07061246.dat, 07061256.dat, and
  346.           91070612.txt.
  347.  
  348.           As detailed information about the events becomes available, a
  349.           bulletin file (probably named seisbull.zip) will be updated.
  350.  
  351.           All files uploaded will have the word 'earthquake' or
  352.           'seismology' in the file description to aid online searches.
  353.  
  354.  
  355.   4.0     Bibliography
  356.  
  357.           These sources will help the reader gain an understanding of some
  358.           aspects of the sciences of seismology and seismometry.  The local
  359.           library or an encyclopedia is the best place to start.
  360.  
  361.           Users finding a useful source of information are encouraged to
  362.           contact the author so this bibliography can be expanded.
  363.  
  364.           Special thanks to those users who have already responded with new
  365.           sources.
  366.  
  367.  
  368.           Bolt, B. A. 1978.  "Earthquakes, A Primer".  W. H. Freeman and
  369.           Company, San Francisco.
  370.  
  371.           Bolt, B. A. 1980.  "Earthquakes and Volcanoes".  W. H. Freeman
  372.           and Company, San Francisco.  ISBN 0-7167-1164-8.
  373.                This book is a collection of articles which appeared in
  374.                Scientific American.
  375.  
  376.           Bolt, B. A. 1976.  "Nuclear Explosions and Earthquakes, The
  377.           Parted Veil".  W. H. Freeman and Company, San Francisco.
  378.  
  379.           Eiby, G. A. 1980.  "Earthquakes".  Van Nostrand Reinhold Company,
  380.           New York.  ISBN 0-442-25191-2.
  381.                This book provides an excellent introduction to the study of
  382.                earthquakes and seismology.
  383.  
  384.           Jeffreys, H. and Bullen, K.E.  1967.  "Seismological Tables".  
  385.                This book contains the 'JB' tables used to determine the
  386.                distance between a seismometer and an earthquake based upon
  387.                the difference in arrival times of the different types of
  388.                waves.  It is probably out of print.  If anyone does find a
  389.                source for this book or the JB tables, please notify the
  390.                author.
  391.  
  392.  
  393.           The Amateur Seismology Package User's Manual                    6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.           Kalmbach Publishing Co. "Earth Magazine".
  401.                This magazine is a new spinoff from Astronomy Magazine.  It
  402.                focuses on the Earth sciences.  No articles on seismology as
  403.                yet, but it appears to be a good source of information for
  404.                the Earth science student.  Kalmbach Publishing Co., 21027
  405.                Crossroads Circle, P.O. Box 1612, Waukesha, WI 53187. 
  406.                Subscription inquiries (800) 446-5489.
  407.  
  408.           Mims, Forrest M. III. 1990. "Engineer's Mini-Notebook Science
  409.           Projects".  Radio Shack (catalog number 276-5018).
  410.                This book contains several electronic science projects,
  411.                including an 'earth movement sensor' and analog data logger.
  412.  
  413.           Neumann, F. 1960. "Principles Underlying the Interpretation of
  414.           Seismograms".  U.S Department of Commerce, Government Printing
  415.           Office.
  416.  
  417.           Science Probe, Inc. "Science PROBE! Magazine".
  418.                This magazine has mentioned amateur seismology, and will
  419.                probably present items of interest in the future.  The
  420.                October 1991 issue contains an article "Science Online",
  421.                which describes BBS systems of interest to Amateur
  422.                Scientists.  Subscription address: Science PROBE!,
  423.                Subscription Department, P.O. Box 54097, Boulder, CO 80322-
  424.                4097.
  425.  
  426.           Simon, R. 1981.  "Earthquake Interpretations, A Manual for
  427.           Reading Seismograms".  William Kaufmann, Inc.
  428.  
  429.           Stong, C. L. 1960.  "The Scientific American Book of Projects For
  430.           the Amateur Scientist".  Simon and Schuster, New York.  Library
  431.           of Congress Catalog Card Number 60-14286.
  432.                This book is a classic collection of articles which appeared
  433.                in the Amateur Scientist column in Scientific American
  434.                during the 1950's.  Three of these articles describe amateur
  435.                seismology and the construction of seismometers and
  436.                seismographs.  The electronic information is dated, but the
  437.                basic information is still useful.  The hardcover version of
  438.                the book is long out of print.  There was a subsequent
  439.                paperback version, but is also probably out of print.  This
  440.                book is a good starting point.  The torsional seismometer
  441.                kit mentioned in "The Attractions of Amateur Seismology" is
  442.                no longer available.
  443.  
  444.           Stong, C. L. 1975.  The Amateur Scientist Column of Scientific
  445.           American, September, 1975. "Electronic stratagems are the key to
  446.           making a sensitive seismometer." Scientific American Inc., New
  447.           York.
  448.                This article describes an electronic seismograph suitable
  449.                for construction by an electronic hobbyist.
  450.  
  451.           Stong, C. L. 1979.  The Amateur Scientist Column of Scientific
  452.           American, July, 1979. Scientific American Inc., New York.
  453.                This article describes an electronic seismograph suitable
  454.                for construction by an electronic hobbyist.  
  455.  
  456.           U.S. Geological Survey.  Bimonthly.  "Earthquakes & Volcanoes".
  457.                This publication contains articles of interest to students
  458.  
  459.           The Amateur Seismology Package User's Manual                    7
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.                of Earth science and the general public.  It is available
  467.                from the Superintendent of Documents, U.S. Government
  468.                Printing Office, Washington, DC 20402.  Order from GPO at
  469.                (202) 783-3238 (VISA or MASTERCARD).  Also try 'go gpo' on
  470.                CompuServe.
  471.  
  472.           U.S. Geological Survey.  Monthly.  "Preliminary Determination of
  473.           Epicenters".
  474.                This publication (commonly known as PDE) contains a listing
  475.                of earthquakes for a given month along with the origin time,
  476.                location, depth, magnitude, etc.  This publication is a few
  477.                months behind; for example the issue containing earthquakes
  478.                for July, 1990 was published in February, 1991. 
  479.                Subscriptions are available from the Superintendent of
  480.                Documents or try 'go gpo' on CompuServe (see above).  For a
  481.                more timely source of this information, see the online
  482.                sources, below.
  483.  
  484.           Online sources:
  485.  
  486.                NEIC BBS:
  487.                     This BBS is operated by the National Earthquake
  488.                     Information Center (NEIC).  The sysop has agreed to
  489.                     create an area on this board to contain the Amateur
  490.                     Seismology package and associated files.  This may also
  491.                     be a good place for users to exchange ideas and
  492.                     information.  This BBS can be reached at (303) 236-0848
  493.                     (setup no parity, eight data bits, 1 stop bit).
  494.  
  495.                QED (Quick Epicenter Determinations):
  496.                     This system is also operated by the NEIC.  The QED
  497.                     system may be used to access NEIC epicenter
  498.                     determinations for events from about two days to one
  499.                     month old.  A description of this system and the
  500.                     procedures to follow to connect it are contained in the
  501.                     file QED.DOC in the SEIS file collection on the NEIC
  502.                     BBS, above.
  503.  
  504.                Try the online news wire services offered on CompuServe and
  505.                perform a keyword search on 'earthquake.'  Beware: news
  506.                services do not always use UTC.
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.           The Amateur Seismology Package User's Manual                    8
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.   5.0     SEISGRAPH - A Program for Viewing and Printing Seismograms
  534.  
  535.           SEISGRAPH is a computer program which allows the user to load
  536.           seismic data files, select a portion of interest for viewing, and
  537.           print the image displayed on a dot matrix printer.
  538.  
  539.  
  540.   5.1     Overview
  541.  
  542.           SEISGRAPH is designed to run on IBM PC compatibles with Hercules,
  543.           CGA, EGA, or VGA graphics.  SEISGRAPH is written in Borland Turbo
  544.           C (*1) and makes use of the Quinn-Curtis Science/Engineering/
  545.           Graphics Tools (part #IPC-TC-006) (*2).
  546.  
  547.           This program is not especially fast or sophisticated.  It is
  548.           intended to be an inexpensive alternative to the many excellent
  549.           (but expensive) data plotting software packages available.
  550.  
  551.           Since this program supports features for monitors and printers
  552.           that the author does not have access to, it was not possible to
  553.           fully test this program (for example, it has never been tried on
  554.           a system with CGA graphics).  It is hoped that by carefully using
  555.           the Quinn-Curtis tools, which have been tested on many systems,
  556.           most problems have been avoided.  It is certain that this program
  557.           contains undetected 'bugs'.  This statement is based upon
  558.           experience as a programmer and a software tester.
  559.  
  560.           The detection of bugs depends upon the users.  Those who use the
  561.           program in a predictable way on a limited variety of data files
  562.           may never have a problem.  Those who take fiendish delight in
  563.           stressing software (sometimes called 'malicious users') will
  564.           probably encounter problems.  Malicious users are a quality
  565.           conscious programmer's best allies.  Oddly enough, it seems to be
  566.           a curious fact that many malicious users are named Al or Allen.
  567.  
  568.           The author encourages the reporting of bugs and freely admits
  569.           that the users are performing the quality control function.
  570.  
  571.           *1   Turbo C is a trademark of Borland International, Inc.
  572.           *2   This product is a trademark of Quinn-Curtis.  For
  573.                information on this and other tools, contact: Quinn-Curtis,
  574.                21 Highland Circle, Needham, MA 02194 USA
  575.  
  576.  
  577.   5.2     Installation
  578.  
  579.           It is assumed that the user has some experience with installing
  580.           PC software.  The installation procedure is very simple.
  581.  
  582.           This package is usually distributed in the form of a ZIP files
  583.           which contain this manual, the SEISGRAPH program, and a sample
  584.           data file.
  585.  
  586.           Copy the SEISGRAPH program (sg.exe) and the sample data file
  587.           (sample.dat) to a directory (for example c:\seis).  In order to
  588.           run the program while in another directory without having to type
  589.           c:\seis\ before each command, it will be necessary to add c:\seis
  590.  
  591.           The Amateur Seismology Package User's Manual                    9
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.           to the PATH.
  599.  
  600.           If you are an inexperienced user and have problems, seek the help
  601.           of a more experienced user.
  602.  
  603.  
  604.   5.3     Guided Tour
  605.  
  606.           The easiest way to explain this program is to walk the user
  607.           through a sample session.  The first step is to install the
  608.           software as described above.
  609.  
  610.           Change the default directory to the directory in which the above
  611.           files were installed or make sure the PATH has been properly set.
  612.  
  613.           To invoke SEISGRAPH, type the following at the prompt followed by
  614.           return:
  615.                sg sample.dat
  616.  
  617.           As SEISGRAPH executes, the following will appear on the screen:
  618.                The copyright notice and support address.
  619.  
  620.                Reading data file: sample.dat
  621.                Reading setup string: S10
  622.                Samples per second: 10
  623.                Time stamp: 910308114539.5
  624.  
  625.                The copyright notice encoded in the data file and any
  626.                additional text describing the contents of the data file.
  627.  
  628.                Samples read: 6000
  629.                First sample: 2065
  630.                Last sample: 2179
  631.                Press ESC to quit or any other key to continue.
  632.  
  633.           Press the ESC key.  The prompt should reappear and the computer
  634.           should behave normally, allowing you to do a DIR or any other
  635.           command.  This verifies that SEISGRAPH was able to allocate
  636.           memory, read the data file, and deallocate memory without
  637.           clashing with any other software that may be running on your
  638.           computer.  If the computer is not operating normally at this
  639.           point or a message appeared that was not listed above, you have
  640.           found a bug (sorry  Al).  Proceed to the Problems and Solutions
  641.           section.
  642.  
  643.           If things have gone well so far, invoke SEISGRAPH again and press
  644.           the space bar (or any key other than ESC).
  645.  
  646.           The screen will go blank, the borders of several boxes will be
  647.           drawn on the screen, and all but two of the bordered boxes will
  648.           disappear as other information is placed on the screen.
  649.  
  650.           Across the top of the screen is an area called the 'stamp
  651.           window.'  At the left side of the window is the file time stamp. 
  652.           This contains the time of the first sample in the file in the
  653.           format 'yr mo da ho:mi:se.t', where yr is the year, mo is the
  654.           month, ho is the hour, mi is the minute, se is the second and t
  655.           is tenths of a second.  ALL DATES AND TIMES ASSOCIATED WITH
  656.  
  657.           The Amateur Seismology Package User's Manual                   10
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.           SEISMIC DATA WILL BE IN UTC.  At the right side of the window is
  665.           data describing the active range of y values in the format 'y_min
  666.           y_span y_max' where y_min is the smallest value to be plotted,
  667.           y_max is the largest value to be plotted, and y_span is the
  668.           difference of y_max and y_min.
  669.  
  670.           Along the left side of the screen is a narrow vertical strip
  671.           called the 'guide y window.'  At the top of this window is a
  672.           (partially obstructed) + sign and at the bottom is a (partially
  673.           obstructed) diamond.  These marks are used to graphically show
  674.           the relative locations of y_min and y_max.
  675.  
  676.           Along the top of the screen, below the stamp window and to the
  677.           right of the guide y window is the 'guide window.'  This window
  678.           will be used to display the entire data file at a reduced scale,
  679.           making it possible to plot a small section of the file and still
  680.           'get the big picture.'
  681.  
  682.           Directly below the guide window is the 'guide x window.'  This
  683.           window is used like the guide y window to show the locations of
  684.           'x_min' (the first sample to be plotted) and 'x_max' (the last
  685.           sample to be plotted) relative to the entire file.
  686.  
  687.           Directly below the guide x window is the 'x text window.'  This
  688.           window is used to show the times associated with x_min and x_max
  689.           in the format min:sec and the sample number within the file
  690.           between the [].  The time difference between x_min and x_max (the
  691.           span of time to be plotted) is centered in the x text window.
  692.  
  693.           Directly below the guide x window is the largest of the windows,
  694.           the 'data window.'  This is where the data bounded by y_min,
  695.           y_max, x_min, and x_max will be plotted.
  696.  
  697.           To the left of the data window is the 'data y window' and
  698.           directly below the data window is the 'data x window.'  The
  699.           functions of these windows parallel the functions of the guide y
  700.           and guide x windows, respectively.
  701.  
  702.           Press the 'g' key.  The entire data file will be plotted in the
  703.           guide window.  Depending on the speed of your computer, this may
  704.           take from 3 to 30 seconds.  After the data is plotted, an x axis
  705.           will be drawn in the guide window with tick marks at one minute
  706.           intervals (the tick marks may be too small to see).
  707.  
  708.           Notice the diamond mark at the far left of the guide x window. 
  709.           Press the right arrow key once.  The diamond will move to the
  710.           right one tick along the x axis, and the x text window will be
  711.           updated to show that x_min has increased by one minute.
  712.  
  713.           Press the space bar.  The diamond on the left of the guide x
  714.           window will change to a + and the + on the far right of the guide
  715.           x window will change to a diamond.  This signifies that x_max is
  716.           now the active limit.  
  717.  
  718.           Press the left arrow key twice.  Notice that x_max decreases by
  719.           two minutes.  Press the right arrow key once.  Notice that x_max
  720.           increases by one minute. 
  721.  
  722.  
  723.           The Amateur Seismology Package User's Manual                   11
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.           In general, a diamond indicates that the corresponding limit is
  731.           active and will be adjusted when an appropriate arrow key is
  732.           pressed.  The left and right arrow keys affect only x_min and
  733.           x_max while the up and down arrow keys affect only y_min and
  734.           y_max.  Pressing the space bar changes between adjusting the min
  735.           or max limits.
  736.  
  737.           Using the space bar and arrow keys, adjust the y_min and y_max
  738.           values in the guide y window and the x_min and x_max values in
  739.           the guide x window until an area of interest in the guide window
  740.           is bounded by the four limits.
  741.  
  742.           Press the 'g' key.  The guide window will be redrawn, with the
  743.           y_min and y_max values selected, but the entire file will be
  744.           plotted, not just the area between x_min and x_max.  This is
  745.           because the guide window is designed to show the entire file.  In
  746.           fact, it is desirable to redraw the guide window with different y
  747.           limits only if the initial y limits do now allow enough detail to
  748.           be shown.  The autorange feature (see Features, below) makes it
  749.           possible to draw the guide window once with limits set based upon
  750.           the actual minimum and maximum values of the data in the data
  751.           file.
  752.  
  753.           Press the 'd' key.  The area of interest selected will now be
  754.           plotted in the data window.  An x axis will be drawn along the
  755.           bottom of the data window with tick marks at 10 second intervals.
  756.  
  757.           The four limits can be adjusted again. The guide x and guide y
  758.           marks will show which area of the entire file will be plotted in
  759.           the data window the next time the 'd' key is pressed and the data
  760.           x and data y marks will show the same area but in greater
  761.           precision since the data marks relate to the data window which is
  762.           at a different scale than the guide window.
  763.  
  764.           The steps by which the limits move in response to the arrow keys
  765.           is adjusted by the function keys.  The effect of each key is
  766.           described in the Features section, below.
  767.  
  768.           Press the ESC key to exit.
  769.  
  770.           The sample data file used during this tour shows the p and s wave
  771.           arrivals (at 30 seconds and 8 minutes 23 seconds into the file,
  772.           respectively) recorded in Minnesota from an earthquake which
  773.           struck near the northern end of the Kamchatka peninsula at about
  774.           1136 UTC.  This is an excellent file, not all events are recorded
  775.           this well.
  776.  
  777.           This completes the guided tour.  Read the Features section and
  778.           experiment to gain an intuitive understanding of the operations
  779.           of the various features.
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.           The Amateur Seismology Package User's Manual                   12
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.   5.4     Features
  797.  
  798.           The features of this program are presented in detail below
  799.           roughly in the order they were used in the guided tour.
  800.  
  801.  
  802.   5.4.1   Invoking SEISGRAPH
  803.  
  804.           SEISGRAPH is started by typing the name of the program, an
  805.           optional 'setup string', and the name of the data file to be
  806.           examined.  In the example above, no setup string was used.  The
  807.           setup string can be used to change some of the ways SEISGRAPH
  808.           executes.  See the Setup String section, below, for details.
  809.  
  810.  
  811.   5.4.2   Reading Data Files
  812.  
  813.           After displaying the copyright message, SEISGRAPH reads the data
  814.           file specified on the command line.  
  815.  
  816.           The first portion of the data file contains a setup string which
  817.           contains information about the format of the data file.  In most
  818.           cases, the only information contained in this setup string will
  819.           be the rate at which data was sampled.  The setup string is read
  820.           and displayed.  Any actions taken as a result of the information
  821.           contained in the string will be displayed.  In the example above,
  822.           the setup string S10 was found and was interpreted as meaning
  823.           that the data in the file was sampled at 10 samples per second.
  824.  
  825.           The second portion of the data file contains the file time stamp
  826.           which will be displayed in the stamp window.  This is the time of
  827.           the first sample in the file.
  828.  
  829.           The next portion of the data file contains text such as copyright
  830.           information or a description of the file contents.
  831.  
  832.           Finally, the data portion of the file is read.  SEISGRAPH can
  833.           read a maximum of 32767 samples and will stop reading the data
  834.           file when this many samples have been read.  Also, only an
  835.           integral number of seconds worth of data will be read and any
  836.           extra data will be discarded.  
  837.  
  838.           When finished reading the data, SEISGRAPH will display the number
  839.           of samples read and the value of the first and last sample.
  840.  
  841.  
  842.   5.4.3   Adjusting X Limits
  843.  
  844.           The x_min and x_max limits are adjusted using the left and right
  845.           arrow keys.  The limit denoted by the diamond shape is the active
  846.           limit which will be changed in response to the arrow keys.  The
  847.           active limit is chosen by pressing and releasing the space bar
  848.           until the desired limit changes from a + to a diamond.
  849.  
  850.           The function keys F1 through F4 determine the step size for x
  851.           limit adjustments as follows:
  852.                F1        1 second steps
  853.                F2        10 second steps
  854.  
  855.           The Amateur Seismology Package User's Manual                   13
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.                F3        1 minute steps      (default at program start)
  863.                F4        10 minute steps
  864.  
  865.           The TAB key moves the range of x values to the 'next' interval
  866.           and the SHIFT-TAB key moves the range of x values to the
  867.           'previous' interval.
  868.  
  869.           The END key moves the active x limit to the end of the current
  870.           data window if the active x limit is currently within the current
  871.           data window.  Otherwise it moves the active x limit to the
  872.           beginning or end of the file.
  873.  
  874.           The x limits will not come closer together than the current x
  875.           step size and TAB/SHIFT-TAB will not move the x range if there is
  876.           not enough room left between the current range and the beginning
  877.           or end of the file.
  878.  
  879.  
  880.   5.4.4   Adjusting Y Limits
  881.  
  882.           The y_min and y_max limits are adjusted using the up and down
  883.           arrow keys.  The limit denoted by the diamond shape is the active
  884.           limit which will be changed in response to the arrow keys.  The
  885.           active limit is chosen by pressing and releasing the space bar
  886.           until the desired limit changes from a + to a diamond.
  887.  
  888.           The function keys F5 through F9 determine the step size for y
  889.           limit adjustments as follows:
  890.                F5        1 count steps
  891.                F6        10 count steps
  892.                F7        100 count steps
  893.                F8        1000 count steps         (default at program
  894.                                                   start)
  895.                F9        10000 count steps
  896.  
  897.           The HOME key performs different functions depending upon whether
  898.           the 'autorange' feature is enabled.  When autorange is not
  899.           enabled, the HOME key moves y_min to 0 and moves y_max to a
  900.           reasonable value (65535, 16383, 4095, 1023, or 255) depending
  901.           upon the largest data value in the file.  When autorange is
  902.           enabled, the HOME key moves y_min to the smallest value and y_max
  903.           to the largest value present in the file.  See the autorange
  904.           feature, below, for instructions on enabling autorange.
  905.  
  906.           The y limits will not come closer together than the current y
  907.           step size.
  908.  
  909.  
  910.   5.4.5   Autorange
  911.  
  912.           The autorange feature is enabled and disabled by the F10 function
  913.           key.  When enabled, 'Autorange' will be displayed in the stamp
  914.           window.  Autorange is not enabled when the program starts, but
  915.           this can be changed through the use of the setup string.
  916.  
  917.  
  918.  
  919.  
  920.  
  921.           The Amateur Seismology Package User's Manual                   14
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.   5.4.6   Guide Window
  929.  
  930.           The guide window is used to display a plot of the entire file. 
  931.           The guide window is drawn when the 'g' key is pressed.
  932.  
  933.  
  934.   5.4.7   Data Window
  935.  
  936.           The data window is used to display a plot of the portion of the
  937.           file bounded by x_min, x_max, y_min, and y_max.  The data window
  938.           is drawn when the 'd' key is pressed.  The data window can be
  939.           drawn with grids along the x axis by pressing the 'x' key or with
  940.           grids along both the x and y axes by pressing the 'b' key.
  941.  
  942.           The timestamp can be displayed in the data window by pressing the
  943.           't' key and the x and y limits can be displayed in the data
  944.           window by pressing the 'i' key.  These features are useful when
  945.           printing the data window.
  946.  
  947.  
  948.   5.4.8   Printing
  949.  
  950.           The plot displayed in the data window can be printed by pressing
  951.           the 'p' key.
  952.  
  953.           The portion of the plot on the right of the data window will be
  954.           the first portion printed.
  955.  
  956.           When printing the contents of an entire file, select a range of x
  957.           values which divides evenly into the file length (so each print
  958.           operation will use the same scale), press TAB until the end of
  959.           the range coincides with the end of the file, and press 'p'. 
  960.           When finished printing this segment, press SHIFT-TAB to move the
  961.           range toward the beginning of the file, press 'd' to draw the new
  962.           range of data, and press 'p'.  Repeat this process until the
  963.           beginning of the range coincides with the beginning of the file.
  964.  
  965.           Unfortunately, the printer driver inserts a blank space between
  966.           print operations.  It is necessary to 'back up' the paper between
  967.           operations or cut and paste the resulting plots.  Note that no
  968.           tick mark is drawn at the left or right end of the x axis.
  969.  
  970.           An alternative to backing up the paper or cutting and pasting
  971.           plots is to press 'c' (for 'continuous printing') instead of
  972.           'p'.  This causes a modified version of printer driver 5 to be
  973.           used, regardless of which printer driver has been selected.  This
  974.           modified driver does not insert the blank space between print
  975.           operations.  Unfortunately, this modified driver may leave a
  976.           small portion of data unprinted.  It is not perfect, but it works
  977.           well and is a good alternative for users of Epson FX printers. 
  978.           For more details on this printer driver, see the Setup String
  979.           section.
  980.  
  981.           Although time and range data normally do not appear in the data
  982.           window, they may be displayed by pressing the 't' and 'i' keys,
  983.           permitting them to be printed along with the data plot.
  984.  
  985.           The Quinn-Curtis tools support a number of printers and
  986.  
  987.           The Amateur Seismology Package User's Manual                   15
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.           resolutions.  For details on selecting the proper configuration
  995.           for your printer, see the Setup String section.
  996.  
  997.  
  998.   5.4.9   Setup String
  999.  
  1000.           The setup string is a series of letters and numbers which can be
  1001.           placed in a data file and/or on the command line to affect the
  1002.           way SEISGRAPH performs certain operations.  When a setup string
  1003.           is encountered, SEISGRAPH displays the string and also displays
  1004.           the information extracted from the string.
  1005.  
  1006.           For example, invoking SEISGRAPH with a setup string (s50ea):
  1007.                sg s50ea sample.dat
  1008.           will cause SEISGRAPH to assume the data was sampled at 50 samples
  1009.           per second, that the data is eight bit data, and will enable the
  1010.           autorange feature.
  1011.  
  1012.           Any information contained in the command line setup string will
  1013.           override any similar information in the data file setup string. 
  1014.           For instance, if the data file contains the setup string s10
  1015.           (interpreted as 10 samples per second) and the command line
  1016.           contains the setup string s5 (interpreted as 5 samples per
  1017.           second), the 5 samples per second value will be used.
  1018.  
  1019.           The following sections describe the options available through use
  1020.           of the setup string.  The default values described are the values
  1021.           SEISGRAPH will use unless overridden by the setup string.
  1022.  
  1023.  
  1024.   5.4.9.1 b (Binary File)
  1025.  
  1026.           When a 'b' appears in a setup string, the data file will be
  1027.           assumed to be a binary file (which contains only data) and not a
  1028.           mixed file (which contains a setup string, timestamp, and
  1029.           possibly text information).  It makes no sense to place a 'b' in
  1030.           a setup string in a data file since a binary file by definition
  1031.           contains no setup string.
  1032.  
  1033.           Placing a 'b' in the command line setup string enables the user
  1034.           to read any file as a data file.  This option is intended to at
  1035.           least make it possible to read files other than those which are a
  1036.           part of the Amateur Seismology Package.
  1037.  
  1038.           If a binary file has been read, no file timestamp will be
  1039.           available.
  1040.  
  1041.           By default, SEISGRAPH expects data files to be of the mixed type.
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.           The Amateur Seismology Package User's Manual                   16
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.   5.4.9.2 e (Eight Bit File)
  1061.  
  1062.           When an 'e' appears in a setup string, the size of the samples in
  1063.           the data file will be assumed to be one byte instead of the
  1064.           default size of two bytes.
  1065.  
  1066.           This option makes it possible to read data files which contain
  1067.           eight bit information but do not fill the extra byte with zeros.
  1068.  
  1069.  
  1070.   5.4.9.3 x (Skip Bytes)
  1071.  
  1072.           An 'x' followed by a number in a setup string will cause
  1073.           SEISGRAPH to skip that number of bytes before beginning to read
  1074.           and store data.  The number of bytes to skip must be <= 32767. 
  1075.           Note that this is the number of BYTES to skip, which will not be
  1076.           the number of samples to skip if the sample size is TWO bytes.
  1077.  
  1078.           This option makes it possible to read mixed files which have all
  1079.           their text information grouped together by placing a 'b' and an
  1080.           'x' followed by the appropriate number of bytes in the setup
  1081.           string.
  1082.  
  1083.           The default value of Skip Bytes is 0.
  1084.  
  1085.   5.4.9.4 c (Color)
  1086.  
  1087.           Placing a 'c' followed by a number in the setup string permits
  1088.           the user to choose which color SEISGRAPH will use.
  1089.  
  1090.           The following list is based upon the table for the Turbo C
  1091.           setallpalette function. The CGA values have not been tested.
  1092.  
  1093.           The default value of Color is 63.
  1094.  
  1095.                     CGA            EGA/VGA
  1096.           0         black          black
  1097.           1         blue           blue
  1098.           2         green          green
  1099.           3         cyan           cyan
  1100.           4         red            red
  1101.           5         magenta        magenta
  1102.           6         brown
  1103.           7         light gray     light gray
  1104.           8         dark gray
  1105.           9         light blue
  1106.           10        light green
  1107.           11        light cyan
  1108.           12        light red
  1109.           13        light magenta
  1110.           14        yellow
  1111.           15        white
  1112.           20                       brown
  1113.           56                       dark gray
  1114.           57                       light blue
  1115.           58                       light green
  1116.           59                       light cyan
  1117.           60                       light red
  1118.  
  1119.           The Amateur Seismology Package User's Manual                   17
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.           61                       light magenta
  1127.           62                       yellow
  1128.           63                       white
  1129.  
  1130.  
  1131.   5.4.9.5 a (Autorange)
  1132.  
  1133.           Placing an 'a' in the setup string enables the autorange feature.
  1134.           This makes it possible to have autorange enabled when the program
  1135.           starts instead of having to press F10 HOME SPACE HOME before
  1136.           drawing the guide window.
  1137.  
  1138.           By default, autorange is not enabled.
  1139.  
  1140.  
  1141.   5.4.9.6 s (Samples Per Second)
  1142.  
  1143.           An 's' followed by a number in the setup string determines the
  1144.           sample rate SEISGRAPH will use.  Samples per second must be <=
  1145.           32767.  
  1146.  
  1147.           Samples per second is normally set in the data file, but may be
  1148.           changed on the command line.  This feature is useful when reading
  1149.           binary data files.  
  1150.  
  1151.           The default value of Samples Per Second is 10.
  1152.  
  1153.  
  1154.   5.4.9.7 b (Bin Size)
  1155.  
  1156.           A 'b' followed by a number in the setup string determines the bin
  1157.           size used when drawing in the guide window.  The number must be
  1158.           >= 2 and <= 32767.
  1159.  
  1160.           Instead of plotting every point in the guide window (which can be
  1161.           very time consuming), data is grouped into bins and the maximum
  1162.           value and the minimum value for each bin is plotted.
  1163.  
  1164.           Making the bin size small increases the fidelity of the plot in
  1165.           the guide window but slows down the plotting process due to the
  1166.           increased number of bins which must be plotted.  Making the bin
  1167.           size large decreases the fidelity of the plot but speeds up the
  1168.           plotting process.
  1169.  
  1170.           The default value of Bin Size is 10.
  1171.  
  1172.  
  1173.   5.4.9.8 p (Printer Port)
  1174.  
  1175.           A 'p' followed by an number in the setup string determines which
  1176.           printer port SEISGRAPH will use.  The number must be 0 (for
  1177.           LPT1:) or 1 (for LPT2:).
  1178.  
  1179.           The default printer port is LPT1:.
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.           The Amateur Seismology Package User's Manual                   18
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.   5.4.9.9 d (Printer Driver) and r (Resolution)
  1193.  
  1194.           Placing a 'd' or 'r' followed by a number in the setup string
  1195.           selects which printer driver and resolution will be used when
  1196.           printing the image contained in the data window.  The user needs
  1197.           to determine which driver and resolution are appropriate for the
  1198.           printer being used.
  1199.  
  1200.           The following table is taken from the documentation for the
  1201.           Quinn-Curtis ScreenDump function.  The author has only tested
  1202.           this package using drivers 5 and 99.
  1203.  
  1204.           The default value for Printer Driver is 5 and the default value
  1205.           for Resolution is 0.
  1206.  
  1207.           Important note:  The author made some modifications to the Quinn-
  1208.           Curtis source code (function GetVertByte in screen.c) to speed up
  1209.           screen dumps at the expense being unable to scale the screen
  1210.           dumps in the x and y directions.  GetVertByte is used by drivers
  1211.           0, 2, 5, and 99.  These modifications were tested with drivers 5
  1212.           and 99 and should work with drivers 0 and 2.  If troubles are
  1213.           encountered while using drivers 0, 2, 5, or 99, please notify the
  1214.           author and do not blame the Quinn-Curtis tools.
  1215.  
  1216.           Another important note:  The author made some modifications to
  1217.           the Quinn-Curtis source code (function EpsonFXScreenDump, driver
  1218.           5) to eliminate the space between print operations.  This
  1219.           modified driver (99) may leave a small amount of data unprinted,
  1220.           but it is a good alternative to backing up the paper or cutting
  1221.           and pasting plots.  In order to use this driver, press 'c'
  1222.           instead of 'p' to print the screen, or use the setup string to
  1223.           select driver 99 and press 'p' to print the screen.
  1224.  
  1225.           Driver:
  1226.                0    Epson MX driver
  1227.                1    Epson LQ driver
  1228.                2    Toshiba P driver
  1229.                3    HP Laser Jet driver
  1230.                4    HP Ink Jet driver
  1231.                5    Epson FX driver
  1232.                99   Modified (no gap) Epson FX driver
  1233.  
  1234.           Resolution:
  1235.                Epson MX, FX drivers
  1236.                     0    single density normal speed
  1237.                     1    double density half speed
  1238.                     2    double density normal speed
  1239.                     3    quadruple density
  1240.  
  1241.                Epson LQ driver
  1242.                     0    single density normal speed 8 pin mode
  1243.                     1    double density half speed 8 pin mode
  1244.                     2    double density normal speed 8 pin mode
  1245.                     3    quadruple density 8 pin mode
  1246.                     4    standard density 24 pin mode
  1247.                     5    double density 24 pin mode
  1248.                     6    CRT III 24 pin mode
  1249.                     7    triple density 24 pin mode
  1250.  
  1251.           The Amateur Seismology Package User's Manual                   19
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.                     8    hex density 24 pin mode
  1259.  
  1260.                Toshiba P driver
  1261.                     0    180x180 dot image transfer
  1262.                     1    180x360 dot image transfer
  1263.  
  1264.                HP Laser Jet driver
  1265.                     0    75 dots/inch
  1266.                     1    100 dots/inch
  1267.                     2    150 dots/inch
  1268.                     3    300 dots/inch
  1269.  
  1270.  
  1271.   5.5     Data File Format
  1272.  
  1273.           SEISGRAPH can be used to read almost any kind of data file
  1274.           (except ASCII formats, commonly used by spreadsheet programs). 
  1275.           This flexibility is provided by the 'b', 'e', 'x', and 's'
  1276.           options in the setup string.
  1277.  
  1278.           The data files distributed with SEISGRAPH and the data files
  1279.           periodically distributed following earthquakes will be in a
  1280.           'mixed' format.  The mixed format is described below.  Users with
  1281.           data acquisition capability are encouraged to use this format to
  1282.           facilitate the exchange of files.
  1283.  
  1284.           The first portion of a mixed file is a setup string.  This string
  1285.           may contain all of the types of information that a setup string
  1286.           on the command line may contain, but it should be limited to
  1287.           contain just the samples per second information.
  1288.  
  1289.           The second portion is the file time stamp.  This string should be
  1290.           in the format described in the guided tour section.  The time
  1291.           stamp in the sample files includes tenths of a second but uses
  1292.           spaces for place holders for hundredths and thousandths of a
  1293.           second.  This is to provide the ability to use more precise file
  1294.           time stamps in the future.
  1295.  
  1296.           The third portion is plain text.
  1297.  
  1298.           All strings must be 80 characters or fewer in length and must be
  1299.           terminated with a newline character ($0A).
  1300.  
  1301.           When SEISGRAPH encounters two newline characters in a row, the
  1302.           rest of the data file will be assumed to be binary data.
  1303.  
  1304.           Data files can be examined using a 'dump' utility or an editor
  1305.           which has the capability to edit binary files.  Trying to use a
  1306.           text editor on a data file may cause undesired results, possibly
  1307.           corrupting the data file.
  1308.  
  1309.   5.6     Problems and Solutions
  1310.  
  1311.           The following is a list of possible error messages, the probable
  1312.           cause, and the appropriate actions.
  1313.  
  1314.           Bad command or file name
  1315.                PC users are used to this one.  The user either mistyped sg,
  1316.  
  1317.           The Amateur Seismology Package User's Manual                   20
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.                the file sg.exe is not in the current directory, or sg.exe
  1325.                is not in the current directory and the path has not been
  1326.                properly set.  Get help from a more experienced PC user.
  1327.  
  1328.           No <optional setup string> or data file name on command line.
  1329.           Usage: SG <optional setup string> data file name.
  1330.                The user typed sg but did not specify a setup string or data
  1331.                file name.
  1332.  
  1333.           OUT OF MEMORY.
  1334.           Unable to create guide data array.
  1335.           Program terminated.
  1336.                SEISGRAPH was unable to find enough memory to hold a maximum
  1337.                and minimum value for each bin. This is due to a small bin
  1338.                size which results in the need for a large number of bins. 
  1339.                Increase Bin Size using the 'b' option in the setup string.
  1340.  
  1341.           OUT OF MEMORY.
  1342.           Unable to create data array.
  1343.           Program terminated.
  1344.                SEISGRAPH was unable to find enough memory to hold 32767 two
  1345.                byte samples.  Either the system does not have enough memory
  1346.                or other programs are using the rest or the memory.  Try
  1347.                running SEISGRAPH without any other programs (TSR utilities,
  1348.                etc.) present.
  1349.  
  1350.           Error opening file:
  1351.                SEISGRAPH was unable to find the specified data file.  If
  1352.                the filename displayed looks like the setup string, it is
  1353.                because the command line contained a setup string and no
  1354.                data file or the data file was entered on the command line
  1355.                before the setup string.
  1356.  
  1357.           No data read.
  1358.           Program terminated.
  1359.                SEISGRAPH read the data file but did not find any data. This
  1360.                may be because there were not two newline characters in a
  1361.                row after the end of plain text in a mixed file or because
  1362.                Skip Bytes was set to a number larger than the total number
  1363.                of samples in the file.
  1364.  
  1365.           Less than one second of data or > 32767 samples per second.
  1366.           Program terminated.
  1367.                SEISGRAPH read the data file but did not find at least one
  1368.                second's worth of data or Samples Per Second was set >
  1369.                32767.  Reduce Samples Per Second using the 's' option in
  1370.                the setup string.
  1371.  
  1372.           Problem with registerbgidriver call.
  1373.           Program terminated.
  1374.                One of the registerbgidriver calls returned an error
  1375.                response.  This should never happen unless sg.exe has
  1376.                somehow become corrupted.
  1377.  
  1378.           CANNOT FIND DRIVER FILE.
  1379.           Program terminated.
  1380.                SEISGRAPH was unable to correctly identify the graphics
  1381.                adapter installed in the computer.  SEISGRAPH will not work
  1382.  
  1383.           The Amateur Seismology Package User's Manual                   21
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.                with this graphics adapter.
  1391.  
  1392.  
  1393.   6.0     How Data Files Are Created
  1394.  
  1395.           The seismometer used to produce the data files is a horizontal
  1396.           pendulum with a period of about 20 seconds.  The transducer is a
  1397.           moving coil - fixed magnet type producing a velocity response. 
  1398.           The seismometer output is filtered, amplified, and sampled at a
  1399.           50 Hz rate by an analog to digital converter (A to D) card
  1400.           installed in a PC.
  1401.  
  1402.           The file time stamp is read from a Heath GC-1000 at the beginning
  1403.           of each data file.  This clock is synchronized to WWV and is
  1404.           usually accurate to 0.01 second, but the computer interface only
  1405.           reports time to the nearest 0.1 second (the delay introduced by
  1406.           the data transfer between the clock and computer is not presently
  1407.           known exactly, but it is less than 0.1 second).  The Heath clock
  1408.           is very accurate but the clock on the A to D card which actually
  1409.           controls the sample rate tends to drift.  This is confirmed by
  1410.           the fact that the file time stamps do not differ by exactly ten
  1411.           minutes.  A rough rule of thumb to follow until the system timing
  1412.           is examined and a better clock is used to control the sample rate
  1413.           is that times are accurate to within about one second.
  1414.  
  1415.           The seismometer is located at approximately 45 degrees north
  1416.           latitude and 93 degrees 20 minutes west longitude.  The pendulum
  1417.           is aligned along a roughly north-south axis and is therefore most
  1418.           sensitive to motion in the east-west direction.
  1419.  
  1420.           The calibration of the system is rather rough at the present
  1421.           time.  Pendulum movement toward the east with respect to the base
  1422.           of the seismometer (the equivalent of ground movement to the
  1423.           west) results in samples with higher values.
  1424.  
  1425.           The filter and amplifier are simple and uncalibrated.  If enough
  1426.           user support materializes, a better amplifier and filter will be
  1427.           built and calibrated.
  1428.  
  1429.           Although the sample rate is 50 Hz, the files are reduced to a
  1430.           sample rate of 10 Hz and compressed with PKZIP before
  1431.           distribution.  If this were not done, the files would be large
  1432.           and would require a much longer time (and more money) to
  1433.           download.
  1434.  
  1435.           The effective sample rate of 10 Hz is sufficient for amateur
  1436.           uses.  However, some of the noise picked up by the seismometer
  1437.           (traffic, trains, etc.) may contain frequencies higher than 5 Hz. 
  1438.           Those familiar with the Nyquist theorem know that this causes
  1439.           'aliasing'.  If enough supporting users want data without this
  1440.           aliasing, an anti-aliasing filter will be installed or the
  1441.           digital data will be filtered before being converted to a 10 Hz
  1442.           sample rate.
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.           The Amateur Seismology Package User's Manual                   22
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.   7.0     The Future
  1457.  
  1458.           Plans for additions and enhancements to this package include:
  1459.  
  1460.                A program for converting data files to/from the ASCII
  1461.                formats used by other plotting/spreadsheet programs.
  1462.  
  1463.                Moving the seismometer to a quieter location.
  1464.  
  1465.                Adjusting the amplifier gain or sampling at two or more
  1466.                different gains so large amplitude waves do not saturate the
  1467.                A to D card.
  1468.  
  1469.                Calibrating the amplifier gain and filter response so the
  1470.                data is more useful.
  1471.  
  1472.           The Amateur Seismology Package is intended to promote interest in
  1473.           the Earth sciences.  If amateur seismology becomes a popular and
  1474.           useful tool in this respect, it is hoped that organizations with
  1475.           access to better seismic data will make this data available on a
  1476.           regular basis.
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.           The Amateur Seismology Package User's Manual                   23
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.          ----------------end-of-author's-documentation---------------
  1522.  
  1523.                          Software Library Information:
  1524.  
  1525.                     This disk copy provided as a service of
  1526.  
  1527.                            Public (software) Library
  1528.  
  1529.          We are not the authors of this program, nor are we associated
  1530.          with the author in any way other than as a distributor of the
  1531.          program in accordance with the author's terms of distribution.
  1532.  
  1533.          Please direct shareware payments and specific questions about
  1534.          this program to the author of the program, whose name appears
  1535.          elsewhere in  this documentation. If you have trouble getting
  1536.          in touch with the author,  we will do whatever we can to help
  1537.          you with your questions. All programs have been tested and do
  1538.          run.  To report problems,  please use the form that is in the
  1539.          file PROBLEM.DOC on many of our disks or in other written for-
  1540.          mat with screen printouts, if possible.  PsL cannot debug pro-
  1541.          programs over the telephone, though we can answer questions.
  1542.  
  1543.          Disks in the PsL are updated  monthly,  so if you did not get
  1544.          this disk directly from the PsL, you should be aware that the
  1545.          files in this set may no longer be the current versions. Also,
  1546.          if you got this disk from another vendor and are having prob-
  1547.          lems,  be aware that  some files may have become corrupted or
  1548.          lost by that vendor. Get a current, working disk from PsL.
  1549.  
  1550.          For a copy of the latest monthly software library newsletter
  1551.          and a list of the 4,000+ disks in the library, call or write
  1552.  
  1553.                            Public (software) Library
  1554.                                P.O.Box 35705 - F
  1555.                             Houston, TX 77235-5705
  1556.  
  1557.                                 1-800-2424-PSL
  1558.                              MC/Visa/AmEx/Discover
  1559.  
  1560.                           Outside of U.S. or in Texas
  1561.                           or for general information,
  1562.                               Call 1-713-524-6394
  1563.  
  1564.  
  1565.